From 20729533756db6038542d95e0d76e07b9b096864 Mon Sep 17 00:00:00 2001 From: Daniel Boles Date: Mon, 12 Mar 2018 16:08:29 +0000 Subject: [PATCH] ListBox: Avoid ::row-activated/Row::activate ambig MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit …uity, by adding a doc comment to Row::activate explaining what it does and why it is probably not what the user reading that is looking for. https://bugzilla.gnome.org/show_bug.cgi?id=794008 --- gtk/gtklistbox.c | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/gtk/gtklistbox.c b/gtk/gtklistbox.c index 50e050a6c6..77dcaf9a56 100644 --- a/gtk/gtklistbox.c +++ b/gtk/gtklistbox.c @@ -3409,6 +3409,14 @@ gtk_list_box_row_class_init (GtkListBoxRowClass *klass) klass->activate = gtk_list_box_row_activate; + /** + * GtkListBoxRow::activate: + * + * This is a keybinding signal, which will cause this row to be activated. + * + * If you want to be notified when the user activates a row (by key or not), + * use the #GtkListBox::row-activated signal on the row’s parent #GtkListBox. + */ row_signals[ROW__ACTIVATE] = g_signal_new (I_("activate"), G_OBJECT_CLASS_TYPE (object_class), -- 2.30.2